home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Memphis Amiga Group / MAG Disk (1989-12)(Memphis Amiga Group).zip / MAG Disk (1989-12)(Memphis Amiga Group).adf / DUTILS2.DOC < prev    next >
Text File  |  1986-11-06  |  23KB  |  422 lines
  1.  
  2.  
  3.                            MANUAL FOR DUTILS2
  4.  
  5. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  6.  
  7.  ED. NOTE: Having used Mike's useful DUTILS, I'd suggest using it with
  8.  an Interlace screen, or keep in mind that there are BACK-TO-FRONT gadgets.
  9.  That is, things might be happening behind the main Dutils window (such as
  10.  when you Edit files or whatever), and it may be worth even setting up a
  11.  special disk for your Dutils use - set Preferences to Interlace, save,
  12.  reboot, and spread out the windows. This is a very powerful program if
  13.  you care to experiment with it. ( See Jonathan Potter's Basic_Tute for
  14.  how to set up special disks.)
  15.  
  16.  DUTILS2 can be used to back up and restore the virus-vulnerable  boot
  17.  blocks of your games disks - it's worth doing this as soon as you get a
  18.  new game. (See "Utilities_Readme" for a further discussion of this.)
  19.  
  20.  Note that when you open Dutils2, you'll see a "rainbow" effect, which is
  21.  simply the program being "unpacked", ie de-compressed, before being
  22.  loaded. This is useful for reducing the size of a program - Dutils2 was
  23.  about 63K before being packed to 37K or so.
  24.  
  25.  Mike tells me to inform people who have already sent in a SHAREWARE
  26.  contribution for the original DUTILS ($10 suggested if you use the program
  27.  regularly) that they will get the final manual for DUTILSII, along with
  28.  any serious enhancements, as they occur. He's been flat out like a lizard
  29.  drinking with the development of this version, and hopes that everyone
  30.  understands that he's got a normal job, wife, kids and so forth. He also
  31.  wants to make the point that SHAREWARE WORKS...sometimes, at least with
  32.  Dutils, and wants to thank everyone who took the trouble to send in a
  33.  contribution over the last couple of months. And there's no doubt that if
  34.  the users of shareware products send in something (like dollars or disks),
  35.  these talented programmers will keep putting out high-quality, low-cost
  36.  software. Whip out the cheque-book, Beryl!
  37.  
  38.  
  39. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  40.  
  41.                                INTRODUCTION
  42.  
  43.         DutilsII is the second version of my Dutils program, now with an
  44.  Intuition user interface. As you will see when run run DutilsII it looks
  45.  somewhat like one of the Directory Utility type programs that have been
  46.  evolving for some time on the Amiga. This should not be surprising as it
  47.  has most of the functionality of these programs, with a lot more added.
  48.    I have built in VIRUS DETECT and KILL functions for both the SCA and
  49.  BYTE BANDIT viruses, a SECTOR EDITOR, a FILE EDITOR, DISKCOPY, FORMAT,
  50.  DISK ERROR CHECK, MULTIPLE FILE SOUND PLAYER, MULTIPLE FILE SLIDE SHOW
  51.  and other utilities.
  52.    In this document I will not be describing how to drive a Directory
  53.  Utility program, only where DUTILS differs. The final user manual, (yes, I
  54.  am actually writing one), will provide more detail.
  55.  
  56.                               GENERAL LAYOUT
  57.  
  58.         The top left of the screen contains the usual file display. One
  59.  difference here is that any selected file or directory will be highlighted
  60.  in system colour 3. DUIII actually uses 2 different colours, I found this
  61.  confusing. The top right of the screen is the track and sector selection
  62.  area. There is a bunch of gadgets here to select which drive, cylinder and
  63.  sector to use for the sector editor, or any other track/sector read
  64.  operation, while below it is a similar cluster of gadgets for the
  65.  destination drive. This drive is the TARGET drive of write operations,
  66.  e.g. Format. There is one odd gadget in the source drive area, this is the
  67.  'NUMBER OF SECTORS' gadget. The value entered here is used by the 'Backup
  68.  Sectors' function. More on this later.
  69.    The bottom of the window contains all of the FUNCTION SELECTION GADGETS
  70.  as well as 3 STRING GADGETS. The 'S' (or SOURCE) string gadget is used
  71.  to enter or display the drive volume and subdirectory selection. The 'D'
  72.  (or destination) string gadget is used to specify a DESTINATION or
  73.  second filename. This string gadget can be used to enter parameters for
  74.  a number of other functions. These will be discussed in their relevant
  75.  sections later. Between these 2 string gadgets is a gadget marked
  76.  'S -> D'. As may be inferred, clicking this gadget will copy the source
  77.  filename to the destination string gadget. This saves time and
  78.  keystrokes. NB: Unlike some DirUtil type programs this is not a swap
  79.  function, it copiess to D only.
  80.  
  81.                         The FUNCTION SELECTION GADGETS.
  82.  
  83.    As discussed above, the 4 rows of gadgets at the bottom of the window
  84.  are used to select a function to be performed. These will be discussed
  85.  seperately below.
  86.  
  87.          The top row of gadgets.
  88.  
  89.    These should be quite self-explanatory to those who have used a DirUtil
  90.  type program before. They select which drive (or volume) should have its
  91.  directory displayed. The Parent gadget takes the source filename back one
  92.  level of subdirectory nesting while the Root gadget goes right back to
  93.  the root directory.
  94.    e.g.  source filename is df0:devs/printers. Clicking PARENT will  change
  95.  the source filename to df0:devs and the displayed directory will be
  96.  updated also. Clicking Root would have changed the filename to df0:.
  97.  
  98.          The second row of gadgets.
  99.  
  100.         The DISKCOPY function provided by Dutils uses the Drive selection
  101.  gadgets at top right of the screen to determine the source and destination
  102.  drives. They default to source = 0, and destination = 1. Any 2 different
  103.  drives may be selected. NB: Dutils does NOT support a single drive diskcopy
  104.  at this time. You will next be prompted via an Auto-Requester as to whether
  105.  you wish to VERIFY the diskcopy. If you select YES, then after the read/write
  106.  pass an additional read back of the written data will be done. As this takes
  107.  longer and if you use good quality media, I generally do not recommend that
  108.  you use Verify. If a read error should occur on the source disk then you will
  109.  be prompted as to whether you wish to format the destination track. The
  110.  positive response causes Dutils to format the corresponding track on the
  111.  destination drive. If you select NO then the destination track will be
  112.  left untouched. If the destination disk has not be used before this will
  113.  leave a 'hole' in the structure of disk. ie A future diskcopy operation
  114.  will again see an error as the destination track has absolutely no data
  115.  at all. On the other hand if you format the track, a future diskcopy  will
  116.  go through without error but the directory structure may well have a hole
  117.  in it. Obviously, if part of a file was on the source track that could
  118.  not be read then the destination file structure is mangled. I'd suggest
  119.  that to recover as much data as possible format the destination track.
  120.  NB: On subsequent errors Dutils will format or leave the destination
  121.  track as you have previously selected, ie you will not be prompted
  122.  further.  When the copy is complete, you will be prompted as to whether
  123.  you would like to copy again. At this point you may change the destination
  124.  or both source and destination diskettes and do another copy.
  125.    As Dutils uses trackdisk.device exclusively to do the disk read/write
  126.  operations it is generally quite reliable and does not introduce spurious
  127.  errors on the copied disk as some well known commercial copiers seem to do.
  128.    The diskcopy operation is not intended to backup protected software.
  129.  
  130.  
  131.                           THE FORMAT FUNCTION.
  132.  
  133.         FORMAT provides an AmigaDOS compatible format function without icons
  134.  for the disk or trashcan. The disk label may be entered into the D string
  135.  gadget before Format is invoked. If no label is specified Empty is assumed.
  136.  [ie, your formatted disk will be called EMPTY.]
  137.         NB The destination drive (default is df1:) is used as the target
  138.  for the format. You will be prompted as to whether you wish a VERIFY
  139.  pass. Like the Diskcopy function, verify is not mandatory, but can be
  140.  very useful for checking suspect diskettes. If errors show up in the
  141.  verify pass, consider throwing that diskette out. It just isn't worth
  142.  losing data to save a couple of bucks on a suspect disk! The FORMAT VERIFY
  143.  works somewhat differently to the DISKCOPY VERIFY in that FORMAT will format
  144.  the whole disk, then verify the whole disk from cylinder 0 to cylinder 79 in
  145.  one pass. The verify pass may be interrupted by clicking on the Stop gadget
  146.  at lower right.
  147.  
  148.                         THE ERROR CHECK FUNCTION.
  149.  
  150.         Error Check (ERRORCHK) performs a read pass over the selected
  151.  source drive in a similar manner to the DiskCopy or Format functions.
  152.  You will be prompted as to whether you wish the error report to be dumped
  153.  to the printer as well as the screen. If you wish this you will be further
  154.  prompted to enter a comment to be printed along with the error report, if
  155.  any. If an error occurs a descriptive error message will be displayed on
  156.  the screen. NB: This function is quite reliable. If it reports an error it
  157.  really is there, conversely if no error is reported then none exists.
  158.         This should be so for all programs but a certain program that is
  159.  very widely used and quite well known not only erroneously reports errors
  160.  on tracks that do not have errors but typically reports the error codes
  161.   as 1 higher than they really are, eg error 21 is reported as error 22.
  162.  
  163.  
  164.                        THE FILECOPY FUNCTION.
  165.  
  166.         FILECOPY copies the selected file (or files) to the
  167.  nominated destination subdirectory. If the SOURCE is in fact a directory
  168.  and there is a path to c:copy, then a directory copy (along with all
  169.  subdirectories) will be performed. NB: Dutils is not yet capable of
  170.  copying subdirectories by itself. It needs to use the AmigaDOS 'copy'
  171.  command. If no path exists to 'copy'then a directory copy will not be
  172.  performed.
  173.  
  174.                         THE RENAME FUNCTION.
  175.  
  176.         The first selected source file is renamed to the nominated
  177.  destination filename. NB: Only the FIRST slected source file will be
  178.  renamed. A planned update will allow multiple source files to be renamed.
  179.  This will in fact implement the useful 'Move' option of DirUTil type
  180.  programs.
  181.  
  182.                         THE DELETE FUNCTION.
  183.  
  184.         All selected source files are deleted. If a directory is selected
  185.  as the source file and a path exists to the AmigaDOS delete command the
  186.  directory (and all subdirectories below it) will be deleted. See FILECOPY.
  187.  
  188.                         THE MAKEDIR FUNCTION.
  189.  
  190.         A directory will be made in the current directory with the name
  191.  specified in the D string gadget.
  192.  
  193.                          THE GETDIR FUNCTION.
  194.  
  195.         The selected subdirectory will be examined, sorted and displayed.
  196.  This directory will become the current directory.
  197.  
  198.                         THE ALL/NONE FUNCTION.
  199.  
  200.         This gadget implements the functions of 2 gadgets normally found
  201.  in DirUtil type programs, namely All and Clear. Clicking once will
  202.  select and highlight all files (but not sub-directories) in the current
  203.  directory. Clicking again will deselect all files but not effect any
  204.  subdirectory selected.
  205.  
  206.                         THE INSTALL FUNCTION.
  207.  
  208.         DUTILS provides an AmigaDOS compatible INSTALL function. INSTALL
  209.  is used to make a disk bootable or to overwrite virused boot sectors,
  210.  i.e.,  cylinder 0, head 0, sectors 0 and 1. The DUTILS INSTALL has the
  211.  added benefit of being able to install boot sectors that will NOT be
  212.  infected by the SCA virus. I have left the option to install 'Normal',
  213.  i.e., absolutely AmigaDOS compatible, boot sectors as well. This way if
  214.  the Anti-SCA virus protection should prove to be a time-bomb.....
  215.  well, I did give YOU the option. I will also be investigating a possible
  216.  anti-BYTE BANDIT boot sector. It appears that if this is possible it
  217.  won't be compatible with anti-SCA virus boot sectors. As the BYTE BANDIT
  218.  virus is considerably more of a nuisance it should take precedence.
  219.  
  220.    N.B.: Do NOT install protected disks. This may destroy their ability to
  221.  boot. See BACKUPS/RESTORES below for more detail.
  222.  
  223.         The full manual will have a detailed description of viruses, how
  224.  to deal with them and avoid them. [ED: see also MegaBites this issue, and
  225.  the Virus Eliminators/Checkers on MD6.]
  226.  
  227.                          THE BackupS FUNCTION.
  228.  
  229.         The Backup Sectors function along with its counterpart
  230.  RestoreS(ectors) are more ANTI-VIRUS UTILITIES. The Backup Sectors
  231.  function is designed to allow any sectors (on the source drive), but
  232.  primarily the BOOT SECTORS (as discussed in Install above) to be saved in
  233.  a file on another disk. The file used should be specified in the D string
  234.  gadget. With a copy of the boot sectors of your favourite games stored
  235.  safely away you need never fear losing another protected disk to a virus
  236.  again. NB A lot of games (eg all Psygnosis games and many others) use the
  237.  boot sectors to provide a loader to load their copy protected program code.
  238.  The viruses also like to live in the boot sectors. As only 1 program can
  239.  live there guess which loses out...that's right, NOT the virus!
  240.         As a file holding the boot sectors of a disk is only 1024 bytes
  241.  you can store a lot of them on 1 diskette. Cheap insurance I'd say! It's
  242.  not always easy to pick the disks with custom boot sectors but as a rule
  243.  of thumb backup any that change screen colour or display a picture
  244.  on the screen very shortly after you insert the disk into df0:.
  245.          I'd suggest you go through your collection of disks and backup
  246.  the boot sectors 'Real Soon Now'. I wonder if software distributors would
  247.  feel it a breach of copyright if these boot sector files appeared on
  248.  electronic bulletin boards?
  249.  
  250.                          THE RestoreS FUNCTION.
  251.         RestoreS (ie Restore Sectors) is the companion to Backup Sectors
  252.  discussed above. Use this function if you have a disk that has had its
  253.  special boot sectors infected by a virus. The selected source file will
  254.  be written into the sectors specified in the destination drive selection
  255.  area (mid right hand side of window).
  256.  
  257.                           THE COMPARE FUNCTION.
  258.  
  259.         The Compare function is actually two fuctions in one. If a source
  260.  file and a destination file are both specified a FILE COMPARE will be
  261.  invoked. If this is not the case a disk comparison will be done.
  262.  
  263.                              FILE COMPARE
  264.  
  265.         The File Compare is on a byte by byte basis, not line by line.
  266.  As with many Dutils functions you will be asked to enter the starting
  267.  address for the comparison, i.e. you do not need to start at the beginning
  268.  of the source file. You will next be prompted as to whether you wish to
  269.  print the results. At each 10 mis-comparisons you will be prompted as to
  270.  whether you wish to continue with the COMPARE.
  271.  
  272.                              DISK COMPARE
  273.          The Disk Compare requires 2 drives. At each 10 mis-comparisons you
  274.  may skip to the continue, quit, skip to the next sector, or skip to the next
  275.  track. As usual you have an option to print the results.
  276.  
  277.                           LIST FILE FUNCTION.
  278.  
  279.         The LIST FILE function is similar to the TYPE function except
  280.  that the text is output using any imbedded carriage return codes to
  281.  terminate the line. This gives a formatted appearance to ASCII (document)
  282.  files. You may scroll through the file using the FORWARD gadget below
  283.  the display window. The STOP gadget is also active at this point. It
  284.  allows you to end the LIST function before the end of the file is reached.
  285.  Binary (executable programs, etc) may display as garbage, in this case use
  286.  the TYPE function instead.
  287.  
  288.          A future enhancement will provide a backward and print option
  289.  for this function.
  290.  
  291.                         THE EXTRACT FILE FUNCTION.
  292.  
  293.         The ExtractF(ile) function is used to copy any part of any file
  294.  to another file. This can be particuarly useful in extracting sound
  295.  effects for example. Firstly, you will be prompted to enter the starting
  296.  address within the source file, then the number of bytes you wish to
  297.  extract. As the file is being extracted the number of bytes left to
  298.  extract will be displayed at the bottom of the window. This is to let you
  299.  see the progress of the function.
  300.  
  301.                            THE SEARCH FUNCTION.
  302.  
  303.         SEARCH allows you to find a string of up to 5 characters in a file.
  304.  The search string must be specified in the D gadget before invoking SEARCH.
  305.  Hex numbers may be imbedded within the search string by preceding them with
  306.  a '\' character. eg TheC\12 -> would search for 4 ASCII characters, 'TheC',
  307.  followed by 12 hex. You may embed hex characters anywhere within the string.
  308.  N.B.: following a \you must give 2 valid hex characters otherwise Search
  309.  will not parse the search string correctly.You may select multiple files to
  310.  be searched. In this case you will be prompted at the completion of the
  311.  search of each file. This is to leave the results on screen for your perusal.
  312.  Acknowledging that the search has finished starts the search of the next
  313.  file. If you select a single file to search, you will be see several more
  314.  prompts. Firstly, you will need to specify the starting address. You will
  315.  also be given the opportunity to copy the results to the printer. Near the
  316.  top left of the window you will be able to observe the progress of the search,
  317.  i.e., the address of current point in the file being compared against the
  318.  search string is displayed. You may interrupt the search by clicking on
  319.  the STOP gadget.
  320.  
  321.                             THE PLAY FUNCTION.
  322.  
  323.         The play function is one of the more unusual aspects of Dutils,
  324.  it allows reproduction of sound effects. In a somewhat similar manner
  325.  to SEARCH above it behaves differently depending on whether you select 1
  326.  or multiple files. If you select multiple files, Play will load them and
  327.  play them at the default playback rate of 10000 samples per second.
  328.  That's 10000 bytes for each second of sound. That's why sound effect
  329.  files can be so big. If the file is IFF the playback rate will be
  330.  extracted and used. If the file is IFF and stereo it will be played back
  331.  in stereo. If only a single file is selected you will next be asked if
  332.  you would like the sound to repeat. If you select YES you will see
  333.  another requester asking whether you would like a pause between repeats.
  334.  If you choose to repeat the sound effect you may interrupt the repetitions
  335.  by clicking on the STOP gadget. Next you will be asked whether you wish
  336.  to vary the playback rate. A value of 20000 samples/sec obviously plays
  337.  the sound at twice normal speed. A value of 5000 samples/sec allows half
  338.  speed. It can be quite amusing to create quite different sounds from a
  339.  sample just by altering the playback rate. The playback rate should
  340.  be entered into the D gadget before selecting play. Simply enter the
  341.  decimal value (eg 10000). You will finally be prompted as to whether you
  342.  would like to PLAY the file again.
  343.  
  344.                              THE SHOW FUNCTION.
  345.  
  346.         The SHOW function displays IFF pictures. Selecting multiple
  347.  files can give a SLIDE SHOW EFFECT. If a decimal number is entered into
  348.  the D gadget before SHOW is clicked that value will be interpreted as
  349.  being a number of seconds to keep the last picture on screen before the
  350.  next is displayed. Otherwise click the left mouse button when ready to
  351.  proceed.
  352.  
  353.  
  354.         We are now down to the BOTTOM ROW OF GADGETS. These are mainly
  355.  for EDITING FILES AND SECTORS with the exception of ABOUT and STOP.
  356.  
  357.                             THE ABOUT FUNCTION.
  358.  
  359.         Clicking on ABOUT simply displays some info about the program.
  360.  There is a way to avoid seeing this screen each time you run DUTILS. All
  361.  registered users will be informed how to do this. Until you register you
  362.  will see it.
  363.  
  364.                     THE BACKWARD AND FORWARDS GADGETS.
  365.  
  366.         These are used simply to move backward and forward in a file or
  367.  sector display, once that display is on screen.
  368.  
  369.                              THE RUN FUNCTION.
  370.  
  371.         This is one of the most useful functions of Dutils. It has 2 modes of
  372.  operation also. If you select a (executable) file and then click RUN, Dutils
  373.  will attempt to run the program. This generally works provided that the
  374.  program being executed has a path to any other files it may need, and that
  375.  enough memory is left. The other way to use this function is to enter any
  376.  valid command line into the D gadget and then click RUN. e.g., Entering the
  377.  following:  'copy fonts all df0:dummy' will (provided there is a path to
  378.  'copy') copy the whole fonts directory including all sub-directories within
  379.  the fonts directory. The results of running either way are put into the
  380.  DUTILS-OUTPUT window which is actually behind the main window of Dutils. You
  381.  may examine this window anytime by using the usual WINDOW FRONT/BACK GADGETS.
  382.  
  383.                       THE TYPE AND HEXTYPE FUNCTIONS.
  384.  
  385.         These are basically the same except that TYPE displays the
  386.  file or sector selected in ASCII printable characters, with any
  387.  unprintable characters displayed as periods. HexType displays in both
  388.  Hex and ASCII, but can display only 1 quarter as much data on screen as
  389.  TYPE. If a file is selected and TYPE or HEXTYPE is clicked then that
  390.  file will be displayed on screen. You will get the opportunity to select
  391.  the starting address. If a file is not selected when TYPE or HEXTYPE is
  392.  selected then the selected sector will be displayed.
  393.  
  394.                             THE EDIT FUNCTION.
  395.  
  396.         To use EDIT you must have previously selected a file or sector
  397.  and clicked TYPE or HEXTYPE. EDIT works on that data shown on screen
  398.  only. Clicking EDIT now will cause a prompt to be displayed asking the
  399.  starting address to edit. You may specify any address in the range
  400.  displayed. You may now skip over bytes of data by pressing return, go back
  401.  through the data by pressing BACKSPACE or stop the EDIT function by
  402.  pressing the 'ESC' key. If data has been modified, i.e., you actually did
  403.  edit something, you will asked to confirm the write back of the modified
  404.  data. If you answer negatively the disk data will not be updated.
  405.  
  406.                             THE PRINT FUNCTION.
  407.  
  408.         PRINT will only print data displayed on screen by TYPE or
  409.  HEXTYPE, or by LIST. If you choose to print the screen data, you will be
  410.  asked to enter a comment as explained above.
  411.  
  412.                              THE STOP GADGET.
  413.  
  414.         STOP is used to interrupt functions like FORMAT, DISKCOPY, SEARCH,
  415.  etc. A requester will be displayed asking you to confirm the ABORT of
  416.  that function. If no operation is underway STOP has the same
  417.  functionality as clicking the WINDOW CLOSE GADGET, that is, to terminate
  418.  DUTILS. Termination of DUTILS must be confirmed by another requester.
  419.  
  420.  
  421. ^^^^^^^^^^^^^^^^^^^^^^^^ END OF DUTILS_MANUAL ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  422.